home *** CD-ROM | disk | FTP | other *** search
/ BMUG Revelations / BMUG Revelations.toast / Utilities / Catalogers / MacLibrarian 1.1.2 / Read Me < prev   
Text File  |  1993-10-15  |  18KB  |  288 lines

  1.  
  2. MacLibrarian™ is a trademark Epsilon Systems.
  3.  
  4. Apple®, the Apple logo, Appletalk®, ImageWriter®, LaserWriter® and Macintosh® are registered trademarks, and MultiFinder™ is a trademark, of Apple Computer, Inc.
  5.  
  6. Microsoft® and the Microsoft logo are registered trademarks of Microsoft Corporation.
  7.  
  8. StuffIt™ is a trademark of Raymond Lau and Aladdin Systems, Inc.
  9.  
  10.  
  11. Epsilon Systems,
  12. 66 Pellan way,
  13. Kanata, Ont.
  14. Canada K2K 1J8
  15. (613) 591 0917
  16.  
  17. American Online:    Behrouz
  18. CompuServe:        70274,3171
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25. Enclosed is MacLibrarian 1.5.  It has had limited testing and a few minor bugs still exist.  Why am I then releasing it?.  Here's why: 
  26. —    the program has many new features that alone make the release worthwhile
  27. —    I found no major bugs during my own testing
  28. —    my beta testers have found no major bugs
  29. —    it has been tested on an SE, II, and Quadra 700.  It has also been tested on System 6.05 and 7.0.
  30.  
  31. I could have held on to it until I was 100% sure that all bugs had been caught but that would take a couple more months.  The many new features included are a direct result of your input.  Their inclusion forced me to completely rewrite the program.  The program is now over 100K lines of code and if you have done any programing I am sure you can appreciate the complexity.  Rather than keep you waiting a couple of months I have decided to release this version.
  32.  
  33. You will receive an upgrade automatically.  The upgrade will include an updated version of the 1.0 manual and bug fixes.  If you find any bugs, please send me a bug report so that I may fix it before the next release.  Your comments and suggestions are also welcome.
  34.  
  35. Before you get started
  36. Please read the following notes before you start using the new version.
  37.  
  38. Copy the contents of the disk supplied into a folder on your hard disk before you start.  
  39. Converting your libraries
  40. Your old libraries are no longer compatible with the new Library format.  A new format was required because MacLibrarian is now memory-based rather than disk-based.  This means that among other things it searches and sorts much faster.  To use your old library you need to convert it using the Converter 1.0->1.5 application.
  41. To convert your library to the new format:
  42. 1.    Double-click the Converter application.
  43. A file dialog box is displayed.  
  44. 2.    Double-click on your version 1.0 library.
  45. The Converter reads you old library into memory and displays a new dialog box.
  46. 3.    Enter a new library name (do not use the version 1.0 name) and click the Save button.
  47. Converter saves your library in the new library format.
  48. Setting memory requirements
  49. MacLibrarian memory requirements are set at 700K.  This should be sufficient for loading a single library.  If you need to open many libraries at the same time, increase the memory requirement to 1000K by first selecting the MacLibrarian application and selecting the Get Info menu item from the File menu in the Finder.
  50.  
  51. Starting MacLibrarian
  52. You can now also start MacLibrarian by double-clicking a new Library document.  
  53.  
  54. Note:  MacLibrarian now displays only one window—the Disk window—when you start the application.  To display the File window, select the Files menu item from the Window menu. 
  55. Opening and managing multiple libraries
  56. MacLibrarian now allows you to have more than one library open at a time.  Note that preference settings are library based; that is, they belong to a particular library.  If you want the same preference settings for all your libraries you have to set them for each library.  
  57.  
  58. When you save a file it remembers your preference settings, the open windows and selected items.  
  59.  
  60. If you close a Disk window for a particular library, then all other windows associated with that library are also closed.  The only time you are asked for confirmation to save a library is when you scan a new disk or delete a disk.  Changing preference settings does not modify the file, therefore you will not get the confirmation to "save changes?"
  61.  
  62. New archives supported
  63. You can now expand the contents of StuffIt, StuffIt Classic, StuffIt Deluxe and  Compactor files by setting the preference Expand Archives.
  64. Printing
  65. Setting Margins
  66. You can now set margins by using the Page Setup menu item from the File menu.
  67. 
  68. Printing selected items
  69. You can now print either the selected items in a window or you can print all the items in the window.  Select the records you want to print, select the Print menu item from the File menu and then select the Print Hilites Only check box.   You can only print items in visible columns.
  70. Managing columns
  71. Adjusting column widths
  72. To adjust the width of a column: select the column divider line in the view area and move it to the desired position.  Your cursor changes to a vertical bar with horizontal arrows indicating that you can change the column widths.  
  73. 
  74.  
  75. Hiding columns
  76. You can also hide columns that you are not interested in by dragging the right column divider line and placing it over the left column divider line of the column you wish to hide.  A hidden column is indicated by a thick divider line in the view title area.  (This feature is similar to the one in Excel).
  77.  
  78. 
  79.  
  80. Changing the title of a column
  81.  To change the column title, double-click in the column title area.  You will be presented with a dialog box that lets you change the title and hide the column if desired.
  82.  
  83. 
  84.  
  85. Making hidden columns visible
  86. To make a hidden column visible: Select the thick divider line in the view title area and drag it to the right.  This will expand all columns that are hidden at that position.
  87. Rearranging columns
  88. No change from version 1.0
  89. Managing the tree window
  90. Opening a tree window
  91.  To open a tree window, double-click on a disk record or file record.  If you double-click on a file record, the tree is expanded to show the hierarchy containing the file record you double-clicked.
  92. 
  93.  
  94. Displaying folders in the tree hierarchy
  95. The plus (+) icon that appears on the folders in the tree is used to indicate  a folder that can be expanded.  The minus (-) icon is used to indicate a folder that has been expanded and can now be collapsed.
  96.  
  97. Double-clicking on a folder with a plus icon expands the folder; that is, it displays the next level in the tree hierarchy.  If you want to expand the entire folder and any folder within (that is, the entire tree hierarchy of the folder) then hold down the Command key and double-click the folder.  
  98.  
  99. To collapse a folder with a minus icon, double-click the minus folder and hold down the Command key.  To hide the contents of the folder double-click on it.  Collapsing a folder removes the contents of the folder from the tree hierarchy.  If you double-click on a collapsed folder you get only next level in the tree hierarchy.  If you double-click on a folder in which you hid the contents, the entire hierarchy that was previously displayed is made visible.  
  100. Displaying archive files in the tree window
  101. Archives files are treated like folders with one exception: if the  Expand Archive preference is enabled then the archive file is shown expanded to the first level.  All folders within the archive are treated as normal folders.  To get the archive to behave like a normal folder, disable the Expand Archive preference.
  102. Displaying file information in the tree window
  103. Clicking on a folder or file displays information about that file on the left side of the tree window.  If the information about the file or folder is not fully visible, you can expand the information display area by moving the pointer to the right edge of the tool area and then clicking and dragging the edge.  At the moment there are two tools displayed in the tool area an arrow and a selection area tool.  The selection area tools does nothing at the moment ( it will later ).
  104. 
  105. Scrolling in the tree window
  106. Scroll in the tree window is now much faster and very much improved for large disks.
  107. Preference override
  108. You can override the file preference settings when loading the library by holding down the option key while the library is being loaded.
  109. Identifying prestamped Files.
  110. You can identify disks that have been electronically stamped as per version 1.0.  The only difference is that the Library name of the file is now also displayed.  There is no need to restamp all your disks since this feature is only used to identify the disk.  However, new scans or updates will include the Library name of the stamped file.
  111. Labelling your disks
  112. Before you can print a label you need to select the disk records of the disks you want to label from the disk window.  The Labels menu item in the File menu of the disk window allows you to create label templates, save the templates, load predefined templates and print labels.  Some predefined label templates are included and it is probably easier to modify these than start from scratch.  Select the Labels menu items to display the following dialog.
  113.  
  114. 
  115.  
  116. This dialog has two views.  The first, shown above, lets you define the label width and height, the vertical and horizontal spacing between labels, the number of labels across and down a page, and the page margins.  You can use the editable text fields or the graphical representation of the label page to define these values.  Selecting any solid line other than the border lets you graphically change any of the label page formats (the exception is the the number of labels across).  
  117.  
  118. The second view (shown below)  lets you define the graphics you want included in the label.  You can toggle between the two views of the dialog by clicking on the icon at the top of the tool area.   The OK button will also take you to second screen but once in the second screen will not bring you back to the first screen.  Instead it will assume that you are done and will return you to the calling Disk window.
  119.  
  120. 
  121. Putting disk information on your disk label
  122. You can include disk information from your library on your label by selecting the desired item from the table at the top of the second view (for example, Num, Stamped) and dragging it anywhere on the label.  When you print the label the value of the view item is substituted.
  123. Once you have dragged a view item to the label, you don't have to delete it and drag another item if you want to change it.  You can double-click and select another view item from the pop-up menu associated with the view item.
  124. Creating objects on your disk label 
  125. You create objects using the tool palette, MacDraw style. The tools in the tool palette are similar to those available with other drawing packages with the following exceptions: the pict tool and the file tool.
  126.  
  127. 
  128.  
  129. The pict tool lets you define an area on the label to paste a picture from another application.  It will rescale the vertical and horizontal size of the picture to fit in the enclosed rectangle.
  130.  
  131. The file tool lets you define an area on the label in which to print a column of the  names of the contents of your disk.  Note only the top-level names of the contents are printed.  If your names spill over the columns, you can define a second area (or as many that will fit) beside the first.  You can define more than one file object on the label.  MacLibrarian keep tracks of the filenames already printed and continues from where it left off on the first column.  This is useful if you want to print two or more columns of filenames on your label.
  132. Adding attributes to an object
  133. To change the attributes to an object.
  134. 1.    Double-click the object.  
  135. You will be presented with a dialog.  
  136. 
  137.  
  138. 2.    Use the dialog to change the attributes of the object.  
  139.     You can change the following attributes: the background pattern of the object, the position of the object, the font, the font size and style (if applicable), and the pen size for the border of the object (if applicable)   
  140.     Note:When the pen size is set to zero, no border is drawn around the object.  The borders surrounding text is for display purposes only and is not printed.
  141. Deleting Objects
  142. To delete an object select it and press the delete key on your keyboard.
  143. Moving Objects to the background and foreground
  144. Select the object and use your Up and Down arrows on your keyboard to move the object to the foreground and background respectively 
  145. Known label bug
  146. The Arc tool does not work as intended so avoid using it.
  147. Saving and retrieving label templates.
  148. Once you have defined your template you can save it to use again at a later date.  
  149. To save a template
  150. 1.    Click the Save Tmplt button in the Label dialog. 
  151. You will be presented with a file dialog.
  152. 2    Enter a filename for the template you wish to save.
  153. To load a template
  154. 1.    Click on the Load Tmplt button in the Label dialog.
  155. You will be presented with a file dialog.
  156. 2.    Select the desired template.
  157. Exporting your data 
  158. You can export your data to file.  This is the preferred method for transferring large amounts of data (as opposed to using the clipboard).  You can Export either all the data associated with a window or just parts of it.  When you select the menu item Export in the File menu a dialog is displayed showing you the options.  Selecting the "Export hilited items only" check box will export only the selected items and selecting "Export visible items only" will export only the visible items.  If neither is selecting then the entire contents of the window is exported.  All data is exported as tab-delimited text.
  159.  
  160. 
  161.  
  162. Setting preferences
  163.  
  164. 
  165.  
  166. Your preference menu is now Library-specific and any new window that is created has the same preference settings.  The only exception to this is the Auto Sort Menu which is window-specific and Cmd-Period Enabled which is session-specific.  Some preferences are not be available in some windows since they increased the complexity of the application with no added value.  
  167.  
  168. The following are the new preferences in this version:
  169.  
  170. Expand Archives—now expands StuffIt, StuffIt Classic, StuffIt Deluxe and Compactor archives when scanning disks.  In addition if Expand Archives is enabled when opening a Tree window or expanding a folder in the tree window the archive is automatically expanded to show the first level of the archive.  If you double-click on the archive it will not collapse or hide the contents of the archive.  If you want to hide the contents of the archive then disable the Expand Archives preference in the tree window.  Don't forget to enable it before doing further scans.
  171.  
  172. Cmd Period Enabled—enabling this option lets you cancel during scan or update operations.  This is useful if you are scanning large disks or CDs.  However, if you are updating very large hard disks then you might want to disable this option since it will keep a copy of the previous scan in memory and will only release the memory when the scan is completed.  This means that the applications memory requirements increase.
  173.  
  174. Display Grid—this preference if enabled will draw grid lines in the Disk and file windows.  If you are running on a Mac+ and find the display to be slow then disable this preference will speed things up a little.
  175.  
  176. Filters
  177. MacLibrarian now supports filters.  Filters are used to exclude certain files from being displayed or printed.  A typical file you might want to filter is the desktop file.  Its Creator is 'ERIK' and its file Type is 'FNDR'.  You can look up the Creator and file Type of the file you want filter in the File window.
  178. To add a filter:
  179. 1.    Select the Filter menu item form the Preference menu.  
  180. A dialog box is displayed showing a list of filters( initially empty).  
  181. 
  182.  
  183. 2.     Enter the Creator signature and File Type and click the add button. 
  184.  The filter is now part of the filter list.  
  185. 3    Enable the Enable filter check box and click on the OK button.
  186.  
  187. MacLibrarian 1.5 Release Notice         Page 
  188.  
  189.  
  190.  
  191.     According to Apple the ImageWriter Parks the paper with the top edge at the pinch-rollers.  This makes it easy for you to rip off the printed pages.  When you start a print job it rolls the paper backwards half an inch of the total inch.  You will notice the IMWR templates for continues labels have the top margin set at 0.25 inch.  In my tests I found that a form feed to the next page would occur if you select the first print position.  This is not a BUG but a limitation of the printer and the type of labels being used( This cost me 3 weeks of test time! ).  The testing was done with an Epson printer with a Grappler Adapter.  You may not see the same problem as I did.  If you do then to minimize wasted labels select the second print position and you will not see this problem.
  192.  
  193. Templates Additions
  194.     If you feel that other users can benefit from the templates you develop.  Then please send me a copy and I will include it in the next release (if suitable).  In addition you need to provide the following information:
  195.     1)   manufacturer of the labels 
  196.     2)   address of the manufacturer
  197.     3)   product number of the labels.
  198.     4)   Your name and address.
  199.     5)   A couple of sheets of the label(for testing).
  200.  
  201. to  MacLibrarian 1.1.2 Registration Form:
  202.  
  203. Mail To:    Epsilon Systems, 
  204.         66 Pellan Way, 
  205.         Kanata, K2K 1J8, 
  206.         Canada.
  207.  
  208. (please print clearly or type.)
  209. Name:
  210. Company:
  211. Address:
  212. City:    State:
  213. Zip:    Country:
  214. Phone: (____) _____ - _______
  215. Electronic Address:
  216.  
  217. Product     QTY     Price    Amount
  218. MacLibrarian 1.1.2 Registration Fee        US$30    
  219.  
  220. The Things I most disliked about MacLibrarian are:
  221.  
  222.  
  223.  
  224.  
  225.  
  226. The things I most liked are:
  227.  
  228.  
  229.  
  230.  
  231.  
  232. I think you should add the following features:
  233.  
  234.  
  235.  
  236.  
  237.  
  238. MacLibrarian has been Used on:
  239. MAC__________     and Sys_____________
  240. Your support for shareware is greatly appreciated.
  241. MacLibrarian 1.1.2 Bug Report:
  242.  
  243. Mail To:    Epsilon Systems,        or send Electronic mail to:
  244.         66 Pellan Way,            American Online:  Behrouz.
  245.         Kanata, K2K 1J8,        Compuserve: 70274,3171
  246.         Canada. 
  247.  
  248. Electronic Mail Address:
  249. American Online User:_________________    Compuserve User ____________________
  250.  
  251. Postal Address:
  252. Name:
  253. Company:
  254. Address:
  255. City:    State:
  256. Zip:    Country:
  257. Phone:(___)_____-________
  258.  
  259. ___________________________________________________________
  260. I am having the following problem with MacLibrarian Version 1.1.2:
  261. Please discribe the necessary steps to recreate the problem:
  262. ( the more detail you can give me the better )
  263. MacLibrarian memory size settings ( from GetInfo):____K
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274. PLEASE FILL IN AS MUCH AS YOU CAN:
  275.  
  276. Machine Type: 
  277. Processor: 
  278. Math Co-Processor: (Y/N)
  279. Color Quickdraw: (Y/N)
  280. Keyboard Type: (Apple Standard?)
  281.  
  282. VERSION NUMBERS
  283. System:             Finder:             Multifinder:
  284. LaserWriter:             ImageWriter:             AppleTalk: 
  285.  
  286. Ram installed:______K        virtual Mem enabled:(Y/N)
  287. Ram Cache: ________K
  288.